* event sources. Thus they should not be relied on for precise timing.
* After each call to the timeout function, the time of the next
* timeout is recalculated based on the current time and the given interval
- * (it does not try to 'catch up' time lost in delays).
+ * (it does not try to “catch up” time lost in delays).
*
* This variant of g_timeout_add_full() can be thought of a MT-safe version
* for GTK+ widgets for the following use case:
*
* The string can either one of a large set of standard names
* (taken from the X11 `rgb.txt` file), or
- * it can be a hex value in the form '#rgb' '#rrggbb'
- * '#rrrgggbbb' or '#rrrrggggbbbb' where 'r', 'g' and
- * 'b' are hex digits of the red, green, and blue components
+ * it can be a hex value in the form “#rgb” “#rrggbb”
+ * “#rrrgggbbb” or “#rrrrggggbbbb” where “r”, “g” and
+ * “b” are hex digits of the red, green, and blue components
* of the color, respectively. (White in the four forms is
- * '#fff', '#ffffff', '#fffffffff' and
- * '#ffffffffffff').
+ * “#fff”, “#ffffff”, “#fffffffff” and
+ * “#ffffffffffff”).
*
* Return value: %TRUE if the parsing succeeded
*/
* gdk_cursor_new_from_pixbuf:
* @display: the #GdkDisplay for which the cursor will be created
* @pixbuf: the #GdkPixbuf containing the cursor image
- * @x: the horizontal offset of the 'hotspot' of the cursor.
- * @y: the vertical offset of the 'hotspot' of the cursor.
+ * @x: the horizontal offset of the “hotspot” of the cursor.
+ * @y: the vertical offset of the “hotspot” of the cursor.
*
* Creates a new cursor from a pixbuf.
*
* gdk_cursor_new_from_surface:
* @display: the #GdkDisplay for which the cursor will be created
* @surface: the cairo image surface containing the cursor pixel data
- * @x: the horizontal offset of the 'hotspot' of the cursor
- * @y: the vertical offset of the 'hotspot' of the cursor
+ * @x: the horizontal offset of the “hotspot” of the cursor
+ * @y: the vertical offset of the “hotspot” of the cursor
*
* Creates a new cursor from a cairo image surface.
*
* usually configured to generate button press events for buttons 4 and 5
* when the wheel is turned.
*
- * Some GDK backends can also generate 'smooth' scroll events, which
+ * Some GDK backends can also generate “smooth” scroll events, which
* can be recognized by the %GDK_SCROLL_SMOOTH scroll direction. For
* these, the scroll deltas can be obtained with
* gdk_event_get_scroll_deltas().
* - For non-percentage values, we accept floats in the range 0-255
* not just [0-9]+ integers
* - For percentage values we accept any float, not just
- * [ 0-9]+ | [0-9]* '.' [0-9]+
+ * [ 0-9]+ | [0-9]* “.” [0-9]+
* - We accept mixed percentages and non-percentages in a single
* rgb() or rgba() specification.
*/
*
* The string can be either one of:
* - A standard name (Taken from the X11 rgb.txt file).
- * - A hex value in the form '#rgb' '#rrggbb' '#rrrgggbbb'
- * or '#rrrrggggbbbb'
- * - A RGB color in the form 'rgb(r,g,b)' (In this case the color will
+ * - A hex value in the form “#rgb” “#rrggbb” “#rrrgggbbb”
+ * or “#rrrrggggbbbb”
+ * - A RGB color in the form “rgb(r,g,b)” (In this case the color will
* have full opacity)
- * - A RGBA color in the form 'rgba(r,g,b,a)'
+ * - A RGBA color in the form “rgba(r,g,b,a)”
*
- * Where 'r', 'g', 'b' and 'a' are respectively the red, green, blue and
+ * Where “r”, “g”, “b” and “a” are respectively the red, green, blue and
* alpha color values. In the last two cases, r g and b are either integers
* in the range 0 to 255 or precentage values in the range 0% to 100%, and
* a is a floating point value in the range 0 to 1.
* Returns a textual specification of @rgba in the form
* `rgb (r, g, b)` or
* `rgba (r, g, b, a)`,
- * where 'r', 'g', 'b' and 'a' represent the red, green,
+ * where “r”, “g”, “b” and “a” represent the red, green,
* blue and alpha values respectively. r, g, and b are
* represented as integers in the range 0 to 255, and a
* is represented as floating point value in the range 0 to 1.
* @screen: a #GdkScreen.
*
* Gets the primary monitor for @screen. The primary monitor
- * is considered the monitor where the 'main desktop' lives.
+ * is considered the monitor where the “main desktop” lives.
* While normal application windows typically allow the window
* manager to place the windows, specialized desktop applications
* such as panels should place themselves on the primary monitor.
#if 0
/*
- * Translators, the strings in the 'keyboard label' context are
+ * Translators, the strings in the “keyboard label” context are
* display names for keyboard keys. Some of them have prefixes like
* XF86 or ISO_ - these should be removed in the translation. Similarly,
- * underscores should be replaced by spaces. The prefix 'KP_' stands
- * for 'key pad' and you may want to include that in your translation.
+ * underscores should be replaced by spaces. The prefix “KP_” stands
+ * for “key pad” and you may want to include that in your translation.
* Here are some examples of English translations:
* XF86AudioMute - Audio mute
* Scroll_lock - Scroll lock
* we need to make sure that the poll function is always called even
* when there are no file descriptors that need to be polled. To do
* this, we add a dummy GPollFD to our event source with a file
- * descriptor of '-1'. Then any time that GLib is polling the event
+ * descriptor of “-1”. Then any time that GLib is polling the event
* source, it will call our poll function.
*/
static GPollFD event_poll_fd;
* @colorsel: a #GtkColorSelection
* @color: a #GdkColor to set the previous color with
*
- * Sets the 'previous' color to be @color.
+ * Sets the “previous” color to be @color.
*
* This function should be called with some hesitations,
* as it might seem confusing to have that color change.
* @colorsel: a #GtkColorSelection
* @alpha: an integer between 0 and 65535
*
- * Sets the 'previous' alpha to be @alpha.
+ * Sets the “previous” alpha to be @alpha.
*
* This function should be called with some hesitations,
* as it might seem confusing to have that alpha change.
* @colorsel: a #GtkColorSelection
* @rgba: a #GdkRGBA to set the previous color with
*
- * Sets the 'previous' color to be @rgba.
+ * Sets the “previous” color to be @rgba.
*
* This function should be called with some hesitations,
* as it might seem confusing to have that color change.
* @fontsel: a #GtkFontSelection
*
* This returns the #GtkTreeView that lists font families, for
- * example, 'Sans', 'Serif', etc.
+ * example, “Sans”, “Serif”, etc.
*
* Return value: (transfer none): A #GtkWidget that is part of @fontsel
*
* @fontsel: a #GtkFontSelection
*
* This returns the #GtkTreeView which lists all styles available for
- * the selected font. For example, 'Regular', 'Bold', etc.
+ * the selected font. For example, “Regular”, “Bold”, etc.
*
* Return value: (transfer none): A #GtkWidget that is part of @fontsel
*
* gtk_font_selection_dialog_get_ok_button:
* @fsd: a #GtkFontSelectionDialog
*
- * Gets the 'OK' button.
+ * Gets the “OK” button.
*
* Return value: (transfer none): the #GtkWidget used in the dialog
- * for the 'OK' button.
+ * for the “OK” button.
*
* Since: 2.14
*
* gtk_font_selection_dialog_get_cancel_button:
* @fsd: a #GtkFontSelectionDialog
*
- * Gets the 'Cancel' button.
+ * Gets the “Cancel” button.
*
* Return value: (transfer none): the #GtkWidget used in the dialog
- * for the 'Cancel' button.
+ * for the “Cancel” button.
*
* Since: 2.14
*
*
* A button box should be used to provide a consistent layout of buttons
* throughout your application. The layout/spacing can be altered by the
- * programmer, or if desired, by the user to alter the 'feel' of a
+ * programmer, or if desired, by the user to alter the “feel” of a
* program to a small degree.
*
* A #GtkHButtonBox is created with gtk_hbutton_box_new(). Buttons are
/**
* SECTION:gtkhsv
- * @Short_description: A 'color wheel' widget
+ * @Short_description: A “color wheel” widget
* @Title: GtkHSV
* @See_also: #GtkColorSelection, #GtkColorSelectionDialog
*
- * #GtkHSV is the 'color wheel' part of a complete color selector widget.
+ * #GtkHSV is the “color wheel” part of a complete color selector widget.
* It allows to select a color by determining its HSV components in an
* intuitive way. Moving the selection around the outer ring changes the hue,
* and moving the selection point inside the inner triangle changes value and
* # Toplevel declarations #
*
* An RC file is a text file which is composed of a sequence
- * of declarations. `'#'` characters delimit comments and
- * the portion of a line after a `'#'` is ignored when parsing
+ * of declarations. `“#”` characters delimit comments and
+ * the portion of a line after a `“#”` is ignored when parsing
* an RC file.
*
* The possible toplevel declarations are:
* @xpadding: An integer value specifying the padding on the left and right of the widget being added to the table.
* @ypadding: The amount of padding above and below the child widget.
*
- * Adds a widget to a table. The number of 'cells' that a widget will occupy is
+ * Adds a widget to a table. The number of “cells” that a widget will occupy is
* specified by @left_attach, @right_attach, @top_attach and @bottom_attach.
* These each represent the leftmost, rightmost, uppermost and lowest column
* and row numbers of the table. (Columns and rows are indexed from zero).
*
* If a name is not specified, it defaults to the action. If an action is
* not specified either, the element name is used. The name and action
- * attributes must not contain '/' characters after parsing (since that
+ * attributes must not contain “/” characters after parsing (since that
* would mess up path lookup) and must be usable as XML attributes when
- * enclosed in doublequotes, thus they must not '"' characters or references
+ * enclosed in doublequotes, thus they must not “"” characters or references
* to the " entity.
*
* # A UI definition #
*
* Looks up a widget by following a path.
* The path consists of the names specified in the XML description of the UI.
- * separated by '/'. Elements which don’t have a name or action attribute in
+ * separated by “/”. Elements which don’t have a name or action attribute in
* the XML (e.g. <popup>) can be addressed by their XML element name
* (e.g. "popup"). The root element ("/ui") can be omitted in the path.
*
*
* A button box should be used to provide a consistent layout of buttons
* throughout your application. The layout/spacing can be altered by the
- * programmer, or if desired, by the user to alter the 'feel' of a
+ * programmer, or if desired, by the user to alter the “feel” of a
* program to a small degree.
*
* A #GtkVButtonBox is created with gtk_vbutton_box_new(). Buttons are
*
* It is also possible to show a #GtkAboutDialog like any other #GtkDialog,
* e.g. using gtk_dialog_run(). In this case, you might need to know that
- * the 'Close' button returns the #GTK_RESPONSE_CANCEL response id.
+ * the “Close” button returns the #GTK_RESPONSE_CANCEL response id.
*/
/* Translators: this is the license preamble; the string at the end
* particular context into a single action group, with namespacing.
*
* Consider the case of two action groups -- one containing actions
- * applicable to an entire application (such as 'quit') and one
+ * applicable to an entire application (such as “quit”) and one
* containing actions applicable to a particular window in the
- * application (such as 'fullscreen').
+ * application (such as “fullscreen”).
*
* In this case, each of these action groups could be added to a
* #GtkActionMuxer with the prefixes “app” and “win”, respectively. This
* actions invoked in a predictable context it is therefore recommended
* that the GDK lock be held while invoking actions locally with
* g_action_group_activate_action(). The same applies to actions
- * associated with #GtkApplicationWindow and to the 'activate' and
+ * associated with #GtkApplicationWindow and to the “activate” and
* 'open' #GApplication methods.
*
* To set an application menu for a GtkApplication, use
* are referred to with an “app.” prefix, and window-specific actions
* with a “win.” prefix.
*
- * GtkApplication also extracts accelerators out of 'accel' attributes
+ * GtkApplication also extracts accelerators out of “accel” attributes
* in the #GMenuModels passed to gtk_application_set_app_menu() and
* gtk_application_set_menubar(), which is usually more convenient
* than calling this function for each accelerator.
*
* A button box should be used to provide a consistent layout of buttons
* throughout your application. The layout/spacing can be altered by the
- * programmer, or if desired, by the user to alter the 'feel' of a
+ * programmer, or if desired, by the user to alter the “feel” of a
* program to a small degree.
*
* gtk_button_box_get_layout() and gtk_button_box_set_layout() retrieve and
*
* # Installing a key binding
*
- * A CSS file binding consists of a 'binding-set' definition and a match
+ * A CSS file binding consists of a “binding-set” definition and a match
* statement to apply the binding set to specific widget types. Details
* on the matching mechanism are described under
* [Selectors][gtkcssprovider-selectors]
*
* Creates a new #GtkButton containing a label.
* If characters in @label are preceded by an underscore, they are underlined.
- * If you need a literal underscore character in a label, use '__' (two
+ * If you need a literal underscore character in a label, use “__” (two
* underscores). The first underlined character represents a keyboard
* accelerator called a mnemonic.
* Pressing Alt and that key activates the button.
* @aprec: precision of alpha parameter in fixed-point format 0.aprec
* @zprec: precision of state parameters zR,zG,zB and zA in fp format 8.zprec
*
- * Performs an in-place blur of image data 'pixels'
- * with kernel of approximate radius 'radius'.
+ * Performs an in-place blur of image data “pixels”
+ * with kernel of approximate radius “radius”.
*
* Blurs with two sided exponential impulse response.
*
* cell alignment in a target allocation (used to draw focus and align
* cells in the icon view).
*
- * Note this is only a trivial 'align * (allocation - request)' operation.
+ * Note this is only a trivial “align * (allocation - request)” operation.
*/
void
_gtk_cell_renderer_calc_offset (GtkCellRenderer *cell,
* not restricted to a flat list, it can be a real tree, and the popup will
* reflect the tree structure.
*
- * To allow the user to enter values not in the model, the 'has-entry'
+ * To allow the user to enter values not in the model, the “has-entry”
* property allows the GtkComboBox to contain a #GtkEntry. This entry
* can be accessed by calling gtk_bin_get_child() on the combo box.
*
* or gtk_combo_box_text_prepend_text() and remove options with
* gtk_combo_box_text_remove().
*
- * If the GtkComboBoxText contains an entry (via the 'has-entry' property),
+ * If the GtkComboBoxText contains an entry (via the “has-entry” property),
* its contents can be retrieved using gtk_combo_box_text_get_active_text().
* The entry itself can be accessed by calling gtk_bin_get_child() on the
* combo box.
* be the theme engine name.
*
* For any type a @parse_func may be provided, being this function
- * used for turning any property value (between ':' and ';') in
+ * used for turning any property value (between “:” and “;”) in
* CSS to the #GValue needed. For basic types there is already
* builtin parsing support, so %NULL may be provided for these
* cases.
* # Style sheets
*
* The basic structure of the style sheets understood by this provider is
- * a series of statements, which are either rule sets or '@-rules', separated
+ * a series of statements, which are either rule sets or “@-rules”, separated
* by whitespace.
*
* A rule set consists of a selector and a declaration block, which is
* Selectors work very similar to the way they do in CSS, with widget class
* names taking the role of element names, and widget names taking the role
* of IDs. When used in a selector, widget names must be prefixed with a
- * '#' character. The '*' character represents the so-called universal
+ * '#' character. The “*” character represents the so-called universal
* selector, which matches any widget.
*
* To express more complicated situations, selectors can be combined in
* that occur inside a GtkToolBar.
* - In the previous example, the GtkButton is matched even
* if it occurs deeply nested inside the toolbar. To restrict the match
- * to direct children of the parent widget, insert a '>' character between
+ * to direct children of the parent widget, insert a “>” character between
* the two selectors. E.g. `GtkNotebook > GtkLabel` matches
* GtkLabel widgets that are direct children of a GtkNotebook.
*
* ]|
*
* Widgets may also define style classes, which can be used for matching.
- * When used in a selector, style classes must be prefixed with a '.'
+ * When used in a selector, style classes must be prefixed with a “.”
* character.
*
* Refer to the documentation of individual widgets to learn which
* color-stop (@position, @color),
* ...)</literallayout>
* where @start_x and @end_x can be either a floating point number between
- * 0 and 1 or one of the special values 'left', 'right' or 'center', @start_y
+ * 0 and 1 or one of the special values “left”, “right” or “center”, @start_y
* and @end_y can be either a floating point number between 0 and 1 or one
- * of the special values 'top', 'bottom' or 'center', @position is a floating
+ * of the special values “top”, “bottom” or “center”, @position is a floating
* point number between 0 and 1 and @color is a color expression (see above).
* The color-stop can be repeated multiple times to add more than one color
- * stop. 'from (@color)' and 'to (@color)' can be used as abbreviations for
+ * stop. “from (@color)” and “to (@color)” can be used as abbreviations for
* color stops with position 0 and 1, respectively.
*
* An example for a linear gradient:
* outlined by border-width.
* The default (stretch) is to resize the slice to fill in the whole
* allocated area.
- * If the value of this property is 'repeat', the image slice
+ * If the value of this property is “repeat”, the image slice
* will be tiled to fill the area.
- * If the value of this property is 'round', the image slice will
+ * If the value of this property is “round”, the image slice will
* be tiled to fill the area, and scaled to fit it exactly
* a whole number of times.
- * If the value of this property is 'space', the image slice will
+ * If the value of this property is “space”, the image slice will
* be tiled to fill the area, and if it doesn’t fit it exactly a whole
* number of times, the extra space is distributed as padding around
* the slices.
* center center, 0.8,
* color-stop (0.0, #fff),
* color-stop (1.0, #000));
- * url ('background.png');</literallayout>
+ * url ("background.png");</literallayout>
* </entry>
* </row>
* <row>
* recommended; it allows you to set the dialog title, some convenient
* flags, and add simple buttons.
*
- * If 'dialog' is a newly created dialog, the two primary areas of the
+ * If “dialog” is a newly created dialog, the two primary areas of the
* window can be accessed through gtk_dialog_get_content_area() and
* gtk_dialog_get_action_area(), as can be seen from the example below.
*
- * A 'modal' dialog (that is, one which freezes the rest of the application
+ * A “modal” dialog (that is, one which freezes the rest of the application
* from user input), can be created by calling gtk_window_set_modal() on the
* dialog. Use the GTK_WINDOW() macro to cast the widget returned from
* gtk_dialog_new() into a #GtkWindow. When using gtk_dialog_new_with_buttons()
*
* When using an entry for passwords and other sensitive information,
* it can be put into “password mode” using gtk_entry_set_visibility().
- * In this mode, entered text is displayed using a 'invisible' character.
+ * In this mode, entered text is displayed using a “invisible” character.
* By default, GTK+ picks the best invisible character that is available
* in the current font, but it can be changed with
* gtk_entry_set_invisible_char(). Since 2.16, GTK+ displays a warning
* The difference between @GTK_INPUT_PURPOSE_DIGITS and
* @GTK_INPUT_PURPOSE_NUMBER is that the former accepts only digits
* while the latter also some punctuation (like commas or points, plus,
- * minus) and 'e' or 'E' as in 3.14E+000.
+ * minus) and “e” or “E” as in 3.14E+000.
*
* This enumeration may be extended in the future; input methods should
- * interpret unknown values as 'free form'.
+ * interpret unknown values as “free form”.
*
* Since: 3.6
*/
*
* Creates a new expander using @label as the text of the label.
* If characters in @label are preceded by an underscore, they are underlined.
- * If you need a literal underscore character in a label, use '__' (two
+ * If you need a literal underscore character in a label, use “__” (two
* underscores). The first underlined character represents a keyboard
* accelerator called a mnemonic.
* Pressing Alt and that key activates the button.
}
/* Handles key press events on the file list, so that we can trap Enter to
- * activate the default button on our own. Also, checks to see if '/' has been
+ * activate the default button on our own. Also, checks to see if “/” has been
* pressed.
*/
static gboolean
* Adds a widget to the grid.
*
* The position of @child is determined by @left and @top. The
- * number of 'cells' that @child will occupy is determined by
+ * number of “cells” that @child will occupy is determined by
* @width and @height.
*/
void
*
* As implementation details, the icon loaded needs to be of SVG type,
* contain the “symbolic” term as the last component of the icon name,
- * and use the 'fg', 'success', 'warning' and 'error' CSS styles in the
+ * and use the “fg”, “success”, “warning” and “error” CSS styles in the
* SVG file itself.
*
* See the [Symbolic Icons Specification](http://www.freedesktop.org/wiki/SymbolicIcons)
* icons, they are in a 1000x1000 coordinate space that is scaled
* to the final size of the icon. You can determine if the icon is an SVG
* icon by using gtk_icon_info_get_filename(), and seeing if it is non-%NULL
- * and ends in '.svg'.
+ * and ends in “.svg”.
*
* This function is provided primarily to allow compatibility wrappers
* for older API's, and is not expected to be useful for applications.
/* Match @locale against @against.
*
- * 'en_US' against 'en_US' => 4
- * 'en_US' against 'en' => 3
- * 'en', 'en_UK' against 'en_US' => 2
- * all locales, against '*' => 1
+ * 'en_US' against “en_US” => 4
+ * 'en_US' against “en” => 3
+ * 'en', “en_UK” against “en_US” => 2
+ * all locales, against “*” => 1
*/
static gint
match_locale (const gchar *locale,
* @info_bar: a #GtkInfoBar
* @response_id: a response ID
*
- * Emits the 'response' signal with the given @response_id.
+ * Emits the “response” signal with the given @response_id.
*
* Since: 2.18
*/
* There are some new fields for links. The links field contains the list
* of GtkLabelLink structs that describe the links which are embedded in
* the label. The active_link field points to the link under the mouse
- * pointer. For keyboard navigation, the 'focus' link is determined by
+ * pointer. For keyboard navigation, the “focus” link is determined by
* finding the link which contains the selection_anchor position.
* The link_clicked field is used with button press and release events
* to ensure that pressing inside a link and releasing outside of it
* @uri: a valid URI
*
* Sets @uri as the URI where the #GtkLinkButton points. As a side-effect
- * this unsets the 'visited' state of the button.
+ * this unsets the “visited” state of the button.
*
* Since: 2.10
*/
/**
* gtk_link_button_set_visited:
* @link_button: a #GtkLinkButton
- * @visited: the new 'visited' state
+ * @visited: the new “visited” state
*
- * Sets the 'visited' state of the URI where the #GtkLinkButton
+ * Sets the “visited” state of the URI where the #GtkLinkButton
* points. See gtk_link_button_get_visited() for more details.
*
* Since: 2.14
* gtk_link_button_get_visited:
* @link_button: a #GtkLinkButton
*
- * Retrieves the 'visited' state of the URI where the #GtkLinkButton
+ * Retrieves the “visited” state of the URI where the #GtkLinkButton
* points. The button becomes visited when it is clicked. If the URI
- * is changed on the button, the 'visited' state is unset again.
+ * is changed on the button, the “visited” state is unset again.
*
* The state may also be changed using gtk_link_button_set_visited().
*
* @top_attach: The row number to attach the top of the item to
* @bottom_attach: The row number to attach the bottom of the item to
*
- * Adds a new #GtkMenuItem to a (table) menu. The number of 'cells' that
+ * Adds a new #GtkMenuItem to a (table) menu. The number of “cells” that
* an item will occupy is specified by @left_attach, @right_attach,
* @top_attach and @bottom_attach. These each represent the leftmost,
* rightmost, uppermost and lower column and row numbers of the table.
* text direction) of the menu aligned with the starting edge of the button.
* If there is not enough space below the button, the menu is popped up above
* the button instead. If the alignment would move part of the menu offscreen,
- * it is 'pushed in'.
+ * it is “pushed in”.
*
* ## Direction = Down
*
* menubars working, if submenu_placement is different for
* the menu and its MenuShell then the following apply:
*
- * - For 'parent' the current menu is not just moved to
+ * - For “parent” the current menu is not just moved to
* the parent, but moved to the previous entry in the parent
* - For 'child', if there is no child, then current is
* moved to the next item in the parent.
* before us (ie: we should add a separator if we have content in
* order to divide us from the items above)
*
- * - if we had a 'label' attribute set for this section
+ * - if we had a “label” attribute set for this section
*
* parent_model and parent_index are passed in so that we can give them
* to the insertion callback so that it can see the label (and anything
* @notebook: a #GtkNotebook
* @child: the #GtkWidget to use as the contents of the page
* @tab_label: (allow-none): the #GtkWidget to be used as the label
- * for the page, or %NULL to use the default label, 'page N'
+ * for the page, or %NULL to use the default label, “page N”
*
* Appends a page to @notebook.
*
* @notebook: a #GtkNotebook
* @child: the #GtkWidget to use as the contents of the page
* @tab_label: (allow-none): the #GtkWidget to be used as the label
- * for the page, or %NULL to use the default label, 'page N'
+ * for the page, or %NULL to use the default label, “page N”
* @menu_label: (allow-none): the widget to use as a label for the
* page-switch menu, if that is enabled. If %NULL, and @tab_label
* is a #GtkLabel or %NULL, then the menu label will be a newly
* @notebook: a #GtkNotebook
* @child: the #GtkWidget to use as the contents of the page
* @tab_label: (allow-none): the #GtkWidget to be used as the label
- * for the page, or %NULL to use the default label, 'page N'
+ * for the page, or %NULL to use the default label, “page N”
*
* Prepends a page to @notebook.
*
* @notebook: a #GtkNotebook
* @child: the #GtkWidget to use as the contents of the page
* @tab_label: (allow-none): the #GtkWidget to be used as the label
- * for the page, or %NULL to use the default label, 'page N'
+ * for the page, or %NULL to use the default label, “page N”
* @menu_label: (allow-none): the widget to use as a label for the
* page-switch menu, if that is enabled. If %NULL, and @tab_label
* is a #GtkLabel or %NULL, then the menu label will be a newly
* @notebook: a #GtkNotebook
* @child: the #GtkWidget to use as the contents of the page
* @tab_label: (allow-none): the #GtkWidget to be used as the label
- * for the page, or %NULL to use the default label, 'page N'
+ * for the page, or %NULL to use the default label, “page N”
* @position: the index (starting at 0) at which to insert the page,
* or -1 to append the page after all other pages
*
* @notebook: a #GtkNotebook
* @child: the #GtkWidget to use as the contents of the page
* @tab_label: (allow-none): the #GtkWidget to be used as the label
- * for the page, or %NULL to use the default label, 'page N'
+ * for the page, or %NULL to use the default label, “page N”
* @menu_label: (allow-none): the widget to use as a label for the
* page-switch menu, if that is enabled. If %NULL, and @tab_label
* is a #GtkLabel or %NULL, then the menu label will be a newly
*
* Changes the tab label for @child.
* If %NULL is specified for @tab_label, then the page will
- * have the label 'page N'.
+ * have the label “page N”.
*/
void
gtk_notebook_set_tab_label (GtkNotebook *notebook,
* realized as subclasses of a common base class (e.g #GtkBox/#GtkHBox/#GtkVBox
* or #GtkScale/#GtkHScale/#GtkVScale). #GtkOrientable is more flexible in that
* it allows the orientation to be changed at runtime, allowing the widgets
- * to 'flip'.
+ * to “flip”.
*
* #GtkOrientable was introduced in GTK+ 2.16.
*/
* @end_offset: return location for the ending offset of the
* current run
*
- * Finds the 'run' around index (i.e. the maximal range of characters
+ * Finds the “run” around index (i.e. the maximal range of characters
* where the set of applicable attributes remains constant) and
* returns the starting and ending offsets for it.
*
* would apply to even and odd rows, respectively.
*
* Region names must only contain lowercase letters
- * and '-', starting always with a lowercase letter.
+ * and “-”, starting always with a lowercase letter.
*
* Since: 3.0
**/
*
* Attaches @context to the given screen.
*
- * The screen is used to add style information from 'global' style
+ * The screen is used to add style information from “global” style
* providers, such as the screens #GtkSettings instance.
*
* If you are using a #GtkStyleContext returned from
*
* A CSS class to match primary toolbars.
*
- * This should be used for the 'main' toolbar of an application,
+ * This should be used for the “main” toolbar of an application,
* right below its menubar.
*/
#define GTK_STYLE_CLASS_PRIMARY_TOOLBAR "primary-toolbar"
/**
* GTK_STYLE_CLASS_SPINNER:
*
- * A CSS class to use when rendering activity as a 'spinner'.
+ * A CSS class to use when rendering activity as a “spinner”.
*
* This is used by #GtkSpinner and #GtkCellRendererSpinner.
*/
*
* This function will search @widget and all its descendants for a GtkLabel
* widget with a text string matching @label_pattern.
- * The @label_pattern may contain asterisks '*' and question marks '?' as
+ * The @label_pattern may contain asterisks “*” and question marks “?” as
* placeholders, g_pattern_match() is used for the matching.
* Note that locales other than "C“ tend to alter (translate” label strings,
* so this function is genrally only useful in test programs with
* @Title: GtkToggleButton
* @See_also: #GtkButton, #GtkCheckButton, #GtkCheckMenuItem
*
- * A #GtkToggleButton is a #GtkButton which will remain 'pressed-in' when
+ * A #GtkToggleButton is a #GtkButton which will remain “pressed-in” when
* clicked. Clicking again will cause the toggle button to return to its
* normal state.
*
* @is_active: %TRUE or %FALSE.
*
* Sets the status of the toggle button. Set to %TRUE if you want the
- * GtkToggleButton to be 'pressed in', and %FALSE to raise it.
+ * GtkToggleButton to be “pressed in”, and %FALSE to raise it.
* This action causes the #GtkToggleButton::toggled signal and the
* #GtkButton::clicked signal to be emitted.
*/
* @is_active: whether @button should be active
*
* Sets the status of the toggle tool button. Set to %TRUE if you
- * want the GtkToggleButton to be 'pressed in', and %FALSE to raise it.
+ * want the GtkToggleButton to be “pressed in”, and %FALSE to raise it.
* This action causes the toggled signal to be emitted.
*
* Since: 2.4
* should be used for the mnemonic accelerator key in the overflow menu. For
* example, if the label property is “_Open” and @use_underline is %TRUE,
* the label on the tool button will be “Open” and the item on the overflow
- * menu will have an underlined 'O'.
+ * menu will have an underlined “O”.
*
* Labels shown on tool buttons never have mnemonics on them; this property
* only affects the menu item on the overflow menu.
* gint int_data;
*
* /* Make sure you terminate calls to gtk_tree_model_get()
- * * with a '-1' value
+ * * with a “-1” value
* */
* gtk_tree_model_get (list_store, &iter,
* STRING_COLUMN, &str_data,
*
* Generates a string representation of the path.
*
- * This string is a ':' separated list of numbers.
+ * This string is a “:” separated list of numbers.
* For example, “4:10:0:3” would be an acceptable
* return value for this string.
*
*
* Generates a string representation of the iter.
*
- * This string is a ':' separated list of numbers.
+ * This string is a “:” separated list of numbers.
* For example, “4:10:0:3” would be an acceptable
* return value for this string.
*
* gtk_tree_model_sort_reset_default_sort_func:
* @tree_model_sort: A #GtkTreeModelSort
*
- * This resets the default sort function to be in the 'unsorted' state. That
+ * This resets the default sort function to be in the “unsorted” state. That
* is, it is in the same order as the child model. It will re-sort the model
* to be in the same order as the child model only if the #GtkTreeModelSort
- * is in 'unsorted' state.
+ * is in “unsorted” state.
**/
void
gtk_tree_model_sort_reset_default_sort_func (GtkTreeModelSort *tree_model_sort)
*/
/*
- * docs about the 'override_browse_mode', we set this flag when we want to
+ * docs about the “override_browse_mode”, we set this flag when we want to
* unset select the node and override the select browse mode behaviour (that is
* 'one node should *always* be selected').
*/
* To find out if the widget has the global input focus, use
* gtk_widget_has_focus().
*
- * Return value: %TRUE if the widget should display a 'focus rectangle'
+ * Return value: %TRUE if the widget should display a “focus rectangle”
*
* Since: 3.2
*/
*
* Inserts @group into @widget. Children of @widget that implement
* #GtkActionable can then be associated with actions in @group by
- * setting their 'action-name' to
+ * setting their “action-name” to
* @prefix.`action-name`.
*
* If @group is %NULL, a previously inserted group for @name is removed
} GtkWidgetHelpType;
/* Macro for casting a pointer to a GtkWidget or GtkWidgetClass pointer.
- * Macros for testing whether `widget' or `klass' are of type GTK_TYPE_WIDGET.
+ * Macros for testing whether widget or klass are of type GTK_TYPE_WIDGET.
*/
#define GTK_TYPE_WIDGET (gtk_widget_get_type ())
#define GTK_WIDGET(widget) (G_TYPE_CHECK_INSTANCE_CAST ((widget), GTK_TYPE_WIDGET, GtkWidget))
* gtk_style_context_add_region().
*
* Region names must only contain lowercase letters
- * and '-', starting always with a lowercase letter.
+ * and “-”, starting always with a lowercase letter.
*
* Since: 3.0
**/
* @geometry: geometry string
*
* Parses a standard X Window System geometry string - see the
- * manual page for X (type 'man X') for details on this.
+ * manual page for X (type “man X”) for details on this.
* gtk_window_parse_geometry() does work on all GTK+ ports
* including Win32 but is primarily intended for an X environment.
*
* if (argc > 1)
* {
* if (!gtk_window_parse_geometry (GTK_WINDOW (window), argv[1]))
- * fprintf (stderr, "Failed to parse '%s'\n", argv[1]);
+ * fprintf (stderr, "Failed to parse “%s”\n", argv[1]);
* }
*
* gtk_widget_show_all (window);
*
* Gets the value of the #GtkWindow:focus-visible property.
*
- * Returns: %TRUE if 'focus rectangles' are supposed to be visible
+ * Returns: %TRUE if “focus rectangles” are supposed to be visible
* in this window.
*
* Since: 3.2
}
/*
- * Finds all dir separators and replaces them with '/'.
+ * Finds all dir separators and replaces them with “/”.
* This makes sure that only /-separated paths are written in cache files,
* maintaining compatibility with theme index files that use slashes as
* directory separators on all platforms.
projects / gtk4.git / commitdiff